home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / utils / dc / dc_jchar.arc / dc_jchar.doc < prev    next >
Encoding:
Text File  |  1991-01-20  |  6.0 KB  |  207 lines
  1. DC Joystick Character v1.0 (DC J-CHAR)
  2.  
  3. Copyright (c) 1991 Double Click Software
  4.  
  5. Program by Michael B. Vederman and Keith Gerdes
  6.  
  7. DC J-CHAR is a FREEWARE program.  A FREEWARE program is one which you may
  8. freely distribute, but you cannot charge for it or alter the program or
  9. contents of the archive in any manner.  Double Click Software retains all
  10. copyright exclusive rights except exclusive distribution.
  11.  
  12. ==============================================================================
  13.  
  14. DC Joystick Character allows you to assign a character to a direction of a
  15. joystick.  When you press the joystick trigger, it simulates entering the
  16. character throught the keyboard.
  17.  
  18. This is useful for doing things like scrolling thru a document, reading
  19. messages on a BBS, etc.  Just sit back in your chair, and press the joystick
  20. button.
  21.  
  22. You may assign up to eight (8) characters; one to each direction of the
  23. joystick.  Use the joystick port only.
  24.  
  25. =========================
  26. DC J-CHAR key assignments
  27. =========================
  28. Before you get started, you should decide what charcters you want to assign
  29. to what joystick direction.
  30.  
  31. DC J-CHAR loads in the text macros from a file named:
  32.  
  33. DC_JCHAR.DAT
  34.  
  35. A sample DC_JCHAR.DAT file looks like:
  36.  
  37. up=A
  38. dn=E
  39. lt=G
  40. rt=C
  41. ur=B
  42. ul=H
  43. dr=D
  44. dl=F
  45.  
  46. Format of the function key definition in DC_FKEYS.DAT is like this:
  47.  
  48. <direction>=<character>
  49.  
  50. where
  51.    <direction> is the text (without single quotes):
  52.  
  53.       'UP' = joystick up
  54.       'DN' = joystick down
  55.       'LT' = joystick left
  56.       'RT' = joystick right
  57.       'UL' = joystick up-left diagonal
  58.       'UR' = joystick up-right diagonal
  59.       'DL' = joystick down-left diagonal
  60.       'DR' = joystick down-right diagonal
  61.  
  62.    = is the equal sign
  63.    
  64.     <character> is any ASCII character
  65.  
  66. So, every line must have the joystick direction _immediately_ followed by
  67. the equals sign '=' and the character.
  68.  
  69. EXAMPLE: DN= 
  70.          UP=U
  71.  
  72. * the first line is actually a space charcter after the equals sign.
  73.  
  74. IMPORTANT NOTE: You may only have one (1) character per direction.
  75.  
  76. ------------------------
  77. Non Printable Characters
  78. ------------------------
  79. You can assign any character by using the backslash '\' character in the
  80. assignement, followed by the DECIMAL value of the character you want, and
  81. another backslash.  Two backslashes '\\' in a row would place by the
  82. backslash character itself.
  83.  
  84. NOTE: You can only use a number from 0 to 255 (any ASCII character).
  85.  
  86. EXAMPLE: UP=\13\
  87.          DN=\\
  88.  
  89. USEFUL CODES:
  90.  
  91. <CARRIAGE RETURN> = 13
  92. <LINE FEED>       = 10
  93.  
  94.  
  95. ====================
  96. Installing DC J-CHAR
  97. ====================
  98. You can install DC J-CHAR either from the AUTO folder or from the desktop.
  99.  
  100. >To install DC J-CHAR from the AUTO folder:
  101. -------------------------------------------
  102.  
  103. 1) Copy DC_JCHAR.PRG and your DC_JCHAR.DAT file into the AUTO folder of
  104.    your bootup disk.
  105.  
  106. 2) Reset your computer.  DC J-CHAR will attempt to load and parse the
  107.    DC_JCHAR.DAT file to define your joystick directions when it runs.
  108.  
  109. When DC J-CHAR installs, you will see an installation message.
  110.  
  111.  
  112. >To install DC J_CHAR from the desktop:
  113. ---------------------------------------
  114.  
  115. 1) Make sure the DC_JCHAR.DAT file is in the CURRENT directory (which is
  116.    usually the same directory the program is in).
  117.  
  118. 2) Run DC_JCHAR.PRG.  An alert box will appear asking you if you want to
  119.    INSTALL or QUIT DC J-CHAR.  Click on the appropriate button.
  120.  
  121. 3) If you clicked on INSTALL, DC J-CHAR will attempt to load and parse the
  122.    DC_JCHAR.DAT file to define your joystick directions.
  123.  
  124. When DC J-CHAR installs, you will see an installation message.
  125.  
  126.  
  127. ===============
  128. Using DC J-CHAR
  129. ===============
  130.  
  131. >Once installed, to use DC J-CHAR:
  132. ----------------------------------
  133.  
  134. 1) Plug the joystick in the joystick port.
  135.  
  136. 2) Push the joystick in the desired direction.
  137.  
  138. 3) Press the joystick trigger.  The character will be typed.
  139.  
  140. NOTE: Pressing the joystick trigger without choosing a direction is the
  141.       same thing as pressing the right mouse button.
  142.  
  143. That's all.
  144.  
  145.  
  146. ================
  147. SOON, SOON, SOON
  148. ================
  149.  
  150. Coming soon to a store near you:  DC SHOWER
  151.  
  152. If you loved DC SHOWIT, you'll love DC SHOWER!
  153.  
  154. This is SHOW magic!  SHOW 'NUF!
  155.  
  156. =============
  157. BUY, BUY, BUY
  158. =============
  159. Have you purchased the DC DESKTOP or DC UTILITIES version 2.0???
  160.  
  161. If not, you owe yourself the pleasure of using our superb programs.
  162.  
  163. "These programs are aSTounding!" - Ken Badertscher, ATARI Corp. talking
  164.                                    about the DC UTILITIES v2.0
  165.  
  166. "The DC DESKTOP is a permanent part of my system!"
  167.    - Ron Luks, Founder of Compuserve's Sig Atari
  168.  
  169. Call us to order, or ask your local retailer.
  170.  
  171.  
  172. ===========
  173. MORE INPUT!
  174. ===========
  175. If you like this program, great!
  176.  
  177. Be sure to let us know what ideas or comments you have about our software.
  178. We are always anxious to hear what anyone has to say!
  179.  
  180. You can reach us almost everywhere!
  181.  
  182. ========
  183. By Phone
  184. ========
  185. Double Click Software  : (713)977-6520
  186.  
  187. ======
  188. Online
  189. ======
  190. GEnie       :  DOUBLE-CLICK (CATegory 30)
  191. CompuServe  :  75300,577    (GO ATARIVend, area 13)
  192. Usenet      :  uace0@menudo.uh.edu
  193. DC BBS      :  (713)944-0108
  194.  
  195.  
  196. ==============================================================================
  197. This program is supplied in the belief that it operates as specified,
  198. neither Double Click Software (the company) nor the authors shall not be liable
  199. in any circumstance whatsoever for any direct or indirect loss or damage to
  200. property incurred or suffered by the customer or any other person as a result
  201. of any fault or defect in the goods or services supplied by the company
  202. and in no circumstances shall the company be liable against consequential
  203. damage or loss of profits (whether or not the possibility thereof was
  204. separately advised to it or reasonably forseeable) arising from the use or
  205. performance of such goods or services.
  206. ==============================================================================
  207.